home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d20 / kill_off.arc / KILL-OFF.DOC < prev    next >
Text File  |  1991-12-17  |  5KB  |  154 lines
  1.  
  2.  
  3.                                 Kill-Off
  4.  
  5.  
  6. An echo distributor utility to removed unused echo areas from an areas
  7. control file.
  8.  
  9. Programming by Remus, chief tester Bob Davis, beta testers the net 106 echo
  10. distributors from 11/90 thru today.  Thanks, guys.
  11.  
  12. Program and documentation (C)Copyright 1990, 1991 Strange Systems.
  13. Permission granted to use freely, and to distribute only for free.
  14.  
  15. This program is guaranteed only to occupy disk space.  If it breaks something,
  16. you get to keep the pieces.
  17.  
  18.  
  19.  
  20.  
  21.  
  22. * Overview
  23.  
  24. Kill-Off removes unused passthru (dead end) echo areas from echo control 
  25. files in ConfMail/QM, Hudson, and Squish forms.
  26.  
  27.  
  28.  
  29. * Theory
  30.  
  31. Kill-Off has been designed to operate once a day during a maintenance event,
  32. but may be run as often as desired.  Kill-Off will use a que file and remove
  33. the echos X days hence, or immediately as detailed later.  Kill-Off can
  34. optionally generate a log file and send an echomail (Fanatics) message when
  35. echos are removed.
  36.  
  37.  
  38.  
  39. * Environment
  40.  
  41. 16 files and 256K are the minimum requirements.  Kill-Off has been tested
  42. under DesqView with no abnormal results.  It is not recommended to allow
  43. Kill-Off and any mail processing / maintenance program to run simutaneously
  44. though; results are unpredictable but will probably range from share
  45. violations to popped hard drive casings.
  46.  
  47. Kill-Off MUST be run in the same directory as AreaFix.Ctl, your areas
  48. control file and Kill-Off.Cfg, and needs access to one (or two) *.Msg message
  49. areas.  Kill-Off generates netmail and optionally an echomail message in
  50. either a netmail area or a BAD_MSGS area.  (See Kill-Off.Cfg for details).
  51.  
  52. A discontinued area will have it's dupefile deleted (N/A for Hudson systems),
  53. and it's directory removed, if applicable.  Note that on any changed files the
  54. original is saved with a .Bak file extender.
  55.  
  56.  
  57.  
  58. * Operation
  59.  
  60. Asking Kill-Off for help (Kill-Off /?) results in the following:
  61.  
  62.  
  63. Kill-Off v0.20; delete unused echo areas, by Remus
  64.   (C) Copyright 1990, 1991 Strange Systems
  65.     Based on source codes of Jon Sabol and Jack Decker
  66.       Haggling & suggestions by Bob Davis
  67.  
  68. Command Options:
  69.  
  70. -Aareas.bbs - force an alternate areas file
  71. -Lfilename  - Logging filespec (IE: -L\Logs\Kill-Off.Log)
  72. -Dn - Set number of days to wait before deleting dead echos, or
  73. -I  - Delete them immediately
  74. -B  - Debugging mode, lots of useless stuff
  75.  
  76.  
  77. Explanation:
  78.  
  79. -Aareas.bbs - Kill-Off normally operates on the file listed in AreaFix.Ctl's
  80.   AREASFILE verb.  This allows an alternate file to be used.  Note that any
  81.   uplinks must still be listed in the FORWARD_LISTs.
  82.  
  83. -Lfilename overrides the log file specifiied in Kill-Off.Cfg.
  84.  
  85. -Dn where n is number of days to wait before asking the echo be disconnected.
  86.   Overrides config file value.
  87.  
  88. -I Deletes echos immediately; overrides -Dn and is equivalent to -D0.
  89.  
  90. -B If Kill-Off doesn't work as desired, try this.  It reports all kinds of
  91.   interesting stuff.  Most of it is useless, but occasionally something
  92.   useful shows up.
  93.  
  94.  
  95.  
  96. * ErrorLevels
  97.  
  98. There are 3 DOS errorlevels that Kill-Off may exit with:
  99.   3 - echos were removed and an 'EchoMail Fanatic' message was written
  100.   2 - echos were removed
  101.   1 - Oops!  An error somewhere ...
  102.  
  103. An errorlevel of 0 indicates normal program termination.
  104.  
  105.  
  106.  
  107. * Setups
  108.  
  109. Common mailer configurations; in all instances it's assumed that NetMail
  110. area be of the *.MSG variety, although any area that messages can be tossed
  111. from will work.
  112.  
  113. QMAIL / CONFMAIL  (default)
  114.   Kill-Off will directly write the 'Fanatics' message to a *.Msg directory.
  115.   Nothing special is required; the default configuration file should suffice.
  116.  
  117.     Fanatics C:\MSG\FANATICS
  118.     Origin - optional
  119.     
  120.  
  121. SQUISH
  122.   There are 2 cases here; first is where the Fanatics area is *.Msg style,
  123.   which uses the default setup.  Second is where the Fanatics area is of the
  124.   Squish variety.  This situation requires Kill-Off to write it's Fanatics
  125.   message to either BAD_MSGS or a NetMail area; it must be of the *.Msg type.
  126.     
  127.     SystemType Squish
  128.     Fanatics C:\MSG\BAD_MSGS
  129.     EchoArea FANATICS
  130.     Origin Another happy Kill-Off user!
  131.  
  132.  
  133. TMAIL
  134.   TMail is a Hudson type processor.  Testing it with Kill-Off has shown that
  135.   it adds an EID, MSGID, a tear and an Origin line to any message not in it's
  136.   correct directory.  Kill-Off's Fanatics message must be sent to either
  137.   NetMail or BAD_MSGS area.  (Again, a *.Msg area).
  138.  
  139.     SystemType Hudson
  140.     Fanatics C:\MSG\BAD_MSGS
  141.     EchoArea FANATICS
  142.     NoControl
  143.  
  144.  
  145.  
  146. * Credits
  147.  
  148. Kill-Off is based on source codes of Jon Sabol and Jack Decker, but is all
  149. original coding.  Source is not available, however.  AreaFix & QM by Greg
  150. Dawson and George Peace, Squish by Scott Dudley.  TMail by Larry Lewis.
  151.  
  152. Remus may be found at FIDOnet 1:106/167.0
  153.  
  154.